home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 1.iso / ARGONET / PD / GRAPHICS / IMAGE165.SPK / !Image / Docs / P4 < prev    next >
Text File  |  1996-11-02  |  10KB  |  242 lines
  1.  
  2. Loading and Saving
  3. ------------------
  4.  
  5. Image can load and save various file formats :
  6.  
  7.     Sprite       - 1, 2, 4, 8, 16 and 32 bpp   (not CMYK)
  8.     Clear files
  9.     JPEG files
  10.     PBMPlus      - PPM and PGM only, not PBM   (only saves P6, raw full colour)
  11.     GIF files    - Memory Permitting
  12.     Image Files  - Image's own full information file format
  13.     TIFF         - Various compression schemes supported
  14.     BMP          - 4, 8 and 24 bpp, uncompressed, save only
  15.     Targa        - save only
  16.     
  17. It can also request ChangeFSI to convert pictures for it, thus it can load
  18. many different picture formats. See below for details.
  19.  
  20. Where files contain more than one picture, the first picture is
  21. loaded.
  22.  
  23. To load a picture simply drag the file to any of Image's windows -
  24. Image will then attempt to load the picture into its current input
  25. image bank (see 'Image Banks').
  26.  
  27. To save an image simply click MENU over the Image Display Window. This
  28. brings up a save window which contains the usual icons, plus icons to
  29. select the output format :
  30.  
  31.    Sprite        - Saves the current display sprite (the sprite used
  32.                    to display in the display window). This will be
  33.                    an old style sprite of 1, 2, 4 or 8 bpp or a new
  34.                    style 16 or 32 bpp sprite (depending
  35.                    on the options set in the configuration window)
  36.                    (See 'Configuration').
  37.    Sprite 32k    - This saves the image as an old style 16 bpp sprite
  38.                    (as used by Computer Concepts' Colour Cards)
  39.                    This option is only available where appropriate.
  40.    16 bpp        - Saves a new style 16 bpp sprite. (actually 15 bpp)
  41.    32 bpp        - Saves a new style 32 bpp sprite. (actually 24 bpp)
  42.    Clear         - Saves a clear file.
  43.    JPEG          - Saves a JPEG file (see below)
  44.    Image         - Saves an Image file (see below)
  45.    TIFF none     - TIFF with no compression
  46.    TIFF LZW      - TIFF with LZW compression
  47.    TIFF packbits - TIFF with packbits compression
  48.    BMP 4/8bit    - Windows BMP format (4 or 8 bpp)
  49.    BMP 24bit     - Windows BMP format (24bpp)
  50.    GIF           - CompuServe GIF format
  51.    Targa         - TrueVision Targa format
  52.  
  53. In all but the 'Sprite' and BMP options the image saved is that which resides
  54. in the current input image bank. 
  55.  
  56. Apart from the 'Image' file format, the masking information is generally lost
  57. when saving a picture, except when saving 'Sprite' and the mask option in the
  58. configuration window is set - or when saving '32 bpp' when the masking
  59. information will be preserved as far as Image is concerned (other
  60. applications will ignore this information).
  61.  
  62. In order to maintain full information (full colour information and
  63. full masking information) you should save as an Image file or a 32 bpp
  64. sprite. Note, however, many current (Risc OS 3.1) applications will not be
  65. able to read this sprite.
  66.  
  67.  
  68. Sprite Palettes
  69. ---------------
  70.  
  71. When loading a sprite, Image can (if requested) load the palette (if
  72. available) which goes with the palette into a special 'User Palette' which
  73. can be used for the display sprite (see 'Configuration').
  74.  
  75. The palette will automatically be loaded if the auto loading option is set in
  76. the configuration window - you can override this by holding down SHIFT when
  77. loading the file.
  78.  
  79. Alternatively, you can force the palette to be loaded into the user palette
  80. by holding down CTRL when loading the sprite.
  81.  
  82.  
  83. When saving a sprite the palette associated with it (either user palette or a
  84. grey scale palette) will be saved with the sprite.
  85.  
  86.  
  87. The 'Image' file format
  88. -----------------------
  89.  
  90. The Image file format is a special format designed for saving the pictures
  91. from image with full information (including masking information) with the
  92. added bonus of compression.
  93.  
  94. The Image format uses special compression routines which produce compression
  95. rates similar, and often better, than similar lossless compression systems.
  96. Compression is generally between 20% and 90%, with an average of
  97. approximately 68% (in tests using a range of pictures) reduction in file size
  98. over a 32bpp sprite (compare with a reduction of 62% for TIFF using LZW
  99. compression).
  100.  
  101. For photo realistic pictures compression averages at a reduction of 46%
  102. (compared with 40% for TIFF).
  103.  
  104.  
  105. Saving JPEG files
  106. -----------------
  107.  
  108. Next to the JPEG option is a writable icon for specifying what 'quality'
  109. value to pass to the JPEG compressor. 
  110.  
  111. The quality value lets you trade off compressed file size against quality of
  112. the reconstructed image: the higher the quality setting, the larger the JPEG
  113. file, and the closer the output image will be to the original input. 
  114. Normally you want to use the lowest quality setting (smallest file) that
  115. decompresses into something visually indistinguishable from the original
  116. image. For this purpose the quality setting should be between 50 and 95; the
  117. default of 75 is often about right. If you see defects at a quality of 75,
  118. then go up 5 or 10 counts at a time until you are happy with the output
  119. image. (The optimal setting will vary from one image to another.)
  120.  
  121. A quality of 100 will generate a quantization table of all 1's, eliminating
  122. loss in the quantization step (but there is still information loss in
  123. subsampling, as well as roundoff error). This setting is mainly of interest
  124. for experimental purposes. Quality values above about 95 are NOT recommended
  125. for normal use; the compressed file size goes up dramatically for hardly any
  126. gain in output image quality.
  127.  
  128. In the other direction, quality values below 50 will produce very small files
  129. of low image quality. Settings around 5 to 10 might be useful in preparing an
  130. index of a large image library, for example.
  131.  
  132.  
  133. BMP Files
  134. ---------
  135.  
  136. Image can save Microsoft Windows BMP files with 4 and 8 bits per pixel. This
  137. option, like 'Sprite', saves a copy of the current display sprite rather than
  138. the current input image bank. For this reason the display sprite must be in
  139. the correct format for the saved file.
  140.  
  141. To produce a 4 bpp (16 colour) BMP file the display sprite must be a 16
  142. colour sprite - similarly for an 8 bpp (256 colour) BMP the display sprite
  143. must be a 256 colour sprite. 
  144.  
  145. The reason that the display sprite is used is to allow BMP files to be saved
  146. using Floyd-Steinberg error diffusion.
  147.  
  148. Loading BMP files is supported by Image through ChangeFSI.
  149.  
  150. 24bpp BMP production is also available, and this (as with most save options)
  151. uses the current input image bank as the source.
  152.  
  153.  
  154. GIF Files
  155. ---------
  156.  
  157. There are three GIF save options:
  158.  
  159.   Gif 24->8
  160.   ---------
  161.   
  162.   This option converts the 24bpp image in the current input bank to an 8bpp
  163.   GIF file with an optimal palette generated from the image.
  164.   
  165.   GIF 8bit
  166.   --------
  167.   
  168.   This option only works if the current display sprite is 8bpp (256 colour).
  169.   It generates a GIF file from the current display sprite and the current
  170.   display palette.
  171.   NOTE: if the current display sprite has a mask then the GIF file produced
  172.   will contain a mask, using the last colour in the display palette as the mask
  173.   colour. Thus to ensure this colour is not used by a dithering operation
  174.   it must match another colour in the palette exactly. The palette supplied
  175.   called 'GIF255' is a version of the standard Risc OS palette which can be
  176.   used for GIF production with mask.
  177.   
  178.   GIF 8bit int
  179.   ------------
  180.   
  181.   This option is similar to the GIF 8bit option, except it produced an
  182.   interlaced GIF file.
  183.  
  184.  
  185. Squashed Files
  186. --------------
  187.  
  188. Image can load files which have been compressed using Acorn's !Squash
  189. application. In order to be able to load these files, however, Acorn's
  190. 'squash' utility needs to be in the path. To ensure this you need to
  191. copy the utility (located in the !Squash application) in the Library
  192. directory (on a Risc PC this is located inside the !Boot application).
  193.  
  194.  
  195. ChangeFSI loading
  196. -----------------
  197.  
  198. If you have a copy of ChangeFSI you can get Image to use it for loading file
  199. formats that Image can't handle itself.
  200.  
  201. In fact if 'ChangeFSI' has been 'seen' by the filer then you need do nothing
  202. to use this facility, any file dragged to Image that Image can't handle
  203. itself will be passed to ChangeFSI to convert, and then Image will load the
  204. converted version.
  205.  
  206. You can also 'teach' Image about the location of 'ChangeFSI' so that it is
  207. not necessary to make sure that the filer has 'seen' it. To do this simply
  208. drag the '!ChangeFSI' application to any of Image's windows, then using the
  209. configuration window save your configuration, and the location of ChangeFSI
  210. will be saved as part of that configuration.
  211.  
  212. The configuration window contains an icon which shows the current location
  213. known for ChangeFSI and also an option icon marked 'New'. This option is used
  214. to tell Image whether the version of ChangeFSI you have is new sprite aware.
  215. If it is (ChangeFSI version 0.95 or later) then this option will cause
  216. ChangeFSI to use a 32 bpp sprite for transfer, otherwise a PPM file is used.
  217. If in doubt as to which version of ChangeFSI you have, you should not select
  218. this option. The advantage of setting this option is that loading will be
  219. faster.
  220.  
  221. ChangeFSI is supplied with RISC OS 3.1 on the RISC OS 3 support disc.
  222.  
  223.  
  224. Acknowledgements
  225. ----------------
  226.  
  227. JPEG loading and saving are handled by software from the 'Independent JPEG
  228. Group's  JPEG software' which has been altered to provide support for Image's
  229. own use.
  230.  
  231. TIFF Loading/Saving uses libtiff:
  232.  * Copyright (c) 1988, 1989, 1990, 1991 Sam Leffler
  233.  * Copyright (c) 1991 Silicon Graphics, Inc.
  234.  *
  235.  * Permission to use, copy, modify, distribute, and sell this software and 
  236.  * its documentation for any purpose is hereby granted without fee, provided
  237.  * that (i) the above copyright notices and this permission notice appear in
  238.  * all copies of the software and related documentation, and (ii) the names of
  239.  * Sam Leffler and Silicon Graphics may not be used in any advertising or
  240.  * publicity relating to the software without the specific, prior written
  241.  * permission of Sam Leffler and Silicon Graphics.
  242.